home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_elm.idb / usr / freeware / doc / elm / Users.cat.z / Users.cat
Encoding:
Text File  |  1998-10-28  |  44.4 KB  |  1,112 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                  TTTThhhheeee EEEEllllmmmm UUUUsssseeeerrrrssss GGGGuuuuiiiiddddeeee
  8.  
  9.  
  10.  
  11.                      _A _p_a_i_n_l_e_s_s _i_n_t_r_o_d_u_c_t_i_o_n _t_o _e_l_e_c_t_r_o_n_i_c _m_a_i_l
  12.                               _u_s_i_n_g _t_h_e EEEEllllmmmm _m_a_i_l _s_y_s_t_e_m
  13.  
  14.  
  15.  
  16.                                  The Elm Mail System
  17.                                     (Version 2.4)
  18.  
  19.  
  20.                            Syd Weinstein, Elm Coordinator
  21.                                Datacomp Systems, Inc.
  22.                                    3837 Byron Road
  23.                           Huntingdon Valley, PA 19006-2320
  24.  
  25.                           email: elm@DSI.COM  or  dsinc!elm
  26.  
  27.  
  28.  
  29.  
  30.                                       AAAABBBBSSSSTTTTRRRRAAAACCCCTTTT
  31.  
  32.                     While  various  UNIX  utilities   have   been
  33.                     designed  to take advantage of the CRT screen
  34.                     (rather than line-oriented systems) electron-
  35.                     ic  mail  systems  haven't "caught the wave".
  36.                     This document presents Elm,  a  sophisticated
  37.                     full-screen  mail system for interactive use.
  38.                     Elm offers all  the  features  of  /_b_i_n/_m_a_i_l,
  39.                     _B_e_r_k_e_l_e_y  _M_a_i_l,  _u_u_m_a_i_l,  _N_M_a_i_l  and the AT&T
  40.                     Mail family of UNIX mailers (namely _P_M_X/_T_E_R_M)
  41.                     in a unified and intuitive fashion.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.                           Copyright 1986,1987 by Dave Taylor
  56.                   Copyright 1988-1992 by The USENET Community Trust
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.                                    EEEEllllmmmm UUUUsssseeeerrrrssss GGGGuuuuiiiiddddeeee
  79.  
  80.                          (The Elm Mail System, Version 2.4)
  81.  
  82.                                    October 1, 1992
  83.  
  84.  
  85.                                     Syd Weinstein
  86.                                Datacomp Systems, Inc.
  87.                                    3837 Byron Road
  88.                           Huntingdon Valley, PA 19006-2320
  89.  
  90.                           email: elm@DSI.COM  or  dsinc!elm
  91.  
  92.  
  93.                                     Derived from
  94.                          "The Elm Mail System, Version 2.0"
  95.                                          by
  96.                                      Dave Taylor
  97.                                   Intuitive Systems
  98.                               Mountain View, California
  99.                     email: taylor@intuitive.com  or  limbo!taylor
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.           1111....  IIIInnnnttttrrrroooodddduuuuccccttttiiiioooonnnn
  107.  
  108.           The UNIX(R) operating system was originally written  on  a  small
  109.           PDP machine, to work with teletypewriters.  Consequently, all the
  110.           original software for the operating system  was  written  with  a
  111.           "tty"  in mind; with line oriented interfaces, rather than screen
  112.           oriented.
  113.  
  114.           Gradually this began to change, and, with  the  addition  of  the
  115.           Berkeley  _v_i  visual shell to the _e_d line editor, the trend began
  116.           to be brought to the attention of UNIX  systems  designers.   And
  117.           yet,  this transition has seemed too subtle for many software en-
  118.           gineers, and so precious few UNIX programs are available designed
  119.           to exploit the entire CRT screen.
  120.  
  121.           Consequently, after becoming more and more disenchanted with  the
  122.  
  123.           __________
  124.           (R)UNIX is  a  registered  trademark  of  UNIX  Systems
  125.           Laboratories.
  126.  
  127.  
  128.           Elm Users Guide                                       Version 2.4
  129.  
  130.  
  131.  
  132.  
  133.  
  134.           Elm Users Guide                                       Version 2.4
  135.  
  136.  
  137.           existing electronic mail facilities (_b_i_n_m_a_i_l and  _B_e_r_k_e_l_e_y  _M_a_i_l)
  138.           Dave  Taylor  decided to undertake creating his own system.  Once
  139.           the ball was rolling  it  became  quite  difficult  not  to  keep
  140.           enhancing  it, especially as he and the Elm Development Group be-
  141.           came more and more familiar with various different mail  systems,
  142.           but  the  result, we hope, is a solid, unified interface to elec-
  143.           tronic mail suitable for almost any environment.
  144.  
  145.           One thing that sets the Elm mail system off from  other  packages
  146.           is  that it comes with an extensive documentation set, including;
  147.           _T_h_e _E_l_m _U_s_e_r_s _G_u_i_d_e, which  you're  holding,  _T_h_e  _E_l_m  _R_e_f_e_r_e_n_c_e
  148.           _G_u_i_d_e,  _T_h_e  _E_l_m  _A_l_i_a_s  _U_s_e_r_s _G_u_i_d_e, _T_h_e _E_l_m _F_i_l_t_e_r _S_y_s_t_e_m _U_s_e_r_s
  149.           _G_u_i_d_e, _T_h_e _E_l_m _F_o_r_m_s _M_o_d_e _G_u_i_d_e, and _T_h_e _E_l_m _C_o_n_f_i_g_u_r_a_t_i_o_n _G_u_i_d_e.
  150.           The names of each indicate what they discuss (not unreasonably).
  151.  
  152.           This particular document contains; this introduction, a  tutorial
  153.           session  with the mailer, a discussion of non-interactive uses of
  154.           Elm, a brief foray into the Elm utilities, and  finally,  credits
  155.           and references.
  156.  
  157.           _T_h_e _E_l_m _R_e_f_e_r_e_n_c_e _G_u_i_d_e contains a much more in-depth  discussion
  158.           of all the possible options available within the Elm environment,
  159.           including the ._e_l_m/_e_l_m_r_c file, the available outbound  mail  pro-
  160.           cessing  features, a section for expert users, suggestions on de-
  161.           bugging strange installations, and many other useful topics.
  162.  
  163.           _T_h_e _E_l_m _A_l_i_a_s _U_s_e_r_s _G_u_i_d_e is the place to go to learn  about  the
  164.           format  of  the  ._e_l_m/_a_l_i_a_s_e_s._t_e_x_t  file  and the associated data
  165.           files, system aliases, and other related topics.
  166.  
  167.           One of the more innovative features of  Elm  is  the  ability  to
  168.           transmit  and  receive  "forms" (as defined by the AT&T Mail sys-
  169.           tem).  To learn about how to create and reply to forms you should
  170.           refer to _T_h_e _E_l_m _F_o_r_m_s _M_o_d_e _G_u_i_d_e.
  171.  
  172.           If you find yourself getting too  much  mail  delivered  in  your
  173.           mailbox,  you  might  be a good candidate for the _f_i_l_t_e_r program.
  174.           To learn more about what this program is and how to use it please
  175.           consult _T_h_e _E_l_m _F_i_l_t_e_r _S_y_s_t_e_m _U_s_e_r_s _G_u_i_d_e.
  176.  
  177.           Finally, if you're working with the actual source  code  and  are
  178.           interested  in  what  all  the locally configured options are and
  179.           mean, please see _T_h_e _E_l_m _C_o_n_f_i_g_u_r_a_t_i_o_n  _G_u_i_d_e.   It  is  strongly
  180.           suggested  that  all  system administrators and people installing
  181.           the system print out the local _s_y_s_d_e_f_s._h file and have  it  handy
  182.           while reading the configuration guide.
  183.  
  184.           The recommended order of learning the Elm system is to skim  this
  185.           guide  until  you  feel confident enough to start up the program.
  186.           Once that's reached, _u_s_e _i_t!  Soon you'll  find  areas  that  you
  187.           need  to  expand into, and you can achieve that by going into the
  188.           options screen within Elm and changing your user level according-
  189.           ly.   After  a while, sit down again and read through this guide.
  190.           You should have a couple  of  "aha!"  intuitive  flashes.   After
  191.  
  192.  
  193.           October 1, 1992                                            Page 2
  194.  
  195.  
  196.  
  197.  
  198.  
  199.           Elm Users Guide                                       Version 2.4
  200.  
  201.  
  202.           another period of time, you're ready to delve into the real power
  203.           of the system and read the reference guide.   The  other  manuals
  204.           should be read as the need arises.
  205.  
  206.           In any case, the system should be usable without reading  _a_n_y  of
  207.           the documentation!
  208.  
  209.           Any comments or problems with any of  the  documentation  or  the
  210.           program  itself  are welcome; if you can't get electronic mail to
  211.           the Elm Development Group, please feel free instead to drop me  a
  212.           note via the overland mail address in the title page.
  213.  
  214.  
  215.           2222....  TTTThhhheeee MMMMaaaaiiiinnnn SSSSyyyysssstttteeeemmmm
  216.  
  217.           Upon entry to the program, the main screen will be  displayed  as
  218.           below:
  219.  
  220.  
  221.             Mailbox is '/usr/mail/mymail' with 15 messages  [Elm 2.4PL22]
  222.            ->   N     1   Apr 24   Larry Fenske   (49)    Hello there
  223.                 N     2   Apr 24   jad@hpcnoe     (84)    Chico?  Why go there?
  224.                 E     3   Apr 23   Carl Smith     (53)    Dinner tonight?
  225.                 NU    4   Apr 18   Don Knuth      (354)   Your version of TeX...
  226.                 N     5   Apr 18   games          (26)    Bug in cribbage game
  227.                  A    6   Apr 15   kevin          (27)    More software requests
  228.                       7   Apr 13   John Jacobs    (194)   How can you hate RUSH?
  229.                  U    8   Apr 8    decvax!mouse   (68)    Re: your Usenet article
  230.                       9   Apr 6    root           (7)
  231.                 O    10   Apr 5    root           (13)
  232.  
  233.           You can use any of the following commands by pressing the first character;
  234.           d)elete or u)ndelete mail, m)ail a message, r)eply or f)orward mail, q)uit
  235.           To read a message, press <return>.  j = move down, k = move up, ? = help
  236.            Command : @
  237.  
  238.           __________________________________________________________________
  239.  
  240.           There are a number of things  to  notice  about  this,  the  main
  241.           screen;
  242.  
  243.  
  244.             +o
  245.              Most likely, on your computer the message  currently  "active"
  246.              will be displayed in an inverse bar rather than being delimit-
  247.              ed by the two character arrow as here.  It's nothing to  worry
  248.              about;  displaying  inverse  video  is just quite difficult on
  249.              printable guides!
  250.  
  251.  
  252.             +o
  253.              The first line on the screen always displays the name  of  the
  254.              current  folder, the number of messages in the folder, and the
  255.              current Elm version number.
  256.  
  257.  
  258.  
  259.           October 1, 1992                                            Page 3
  260.  
  261.  
  262.  
  263.  
  264.  
  265.           Elm Users Guide                                       Version 2.4
  266.  
  267.  
  268.             +o
  269.              The arrow ("->") or inverse video  bar  will  always  indicate
  270.              which is the current message.
  271.  
  272.  
  273.             +o
  274.              The first field that appears associated with each  message  is
  275.              the status field.  This can be blank (as with most of the ones
  276.              above, or can have any combination of the following:
  277.  
  278.              The first character signifies temporary status:
  279.  
  280.                    E       for an _e_x_p_i_r_e_d message
  281.                    N       for a _n_e_w message
  282.                    O       for an _o_l_d (i.e. not new but not read) message
  283.                    D       for a _d_e_l_e_t_e_d message
  284.  
  285.              The second character which signifies permanent status:
  286.  
  287.                    C       for _c_o_n_f_i_d_e_n_t_i_a_l mail
  288.                    U       for _u_r_g_e_n_t mail
  289.                    P       for a _p_r_i_v_a_t_e message
  290.                    A       for messages that have an _a_c_t_i_o_n associated with them
  291.                    F       for a _f_o_r_m letter
  292.                    M       for a _M_I_M_E compliant message
  293.  
  294.              The third character of the status field can be a '+' to  indi-
  295.              cate that the message is _t_a_g_g_e_d too.
  296.  
  297.  
  298.             +o
  299.              Continuing from left to right, the next field is  the  message
  300.              number.   For  the  most  part you can ignore these unless you
  301.              want to quickly move to  a  specific  message  (as  we'll  see
  302.              later).
  303.  
  304.  
  305.             +o
  306.              The date associated with each message is  typically  the  date
  307.              the person actually _s_e_n_t the message.
  308.  
  309.  
  310.             +o
  311.              The next field displayed indicates whom the message  is  from.
  312.              Elm  will  try to display the _f_u_l_l _n_a_m_e of the person who sent
  313.              the message, rather than the their return address or  computer
  314.              login.   Some  systems  don't  generate  the  correct headers,
  315.              though, hence messages like numbers 2 and 8, where it's  their
  316.              return address.
  317.  
  318.  
  319.             +o
  320.              The number in parentheses is the total number of lines in  the
  321.              message.
  322.  
  323.  
  324.           October 1, 1992                                            Page 4
  325.  
  326.  
  327.  
  328.  
  329.  
  330.           Elm Users Guide                                       Version 2.4
  331.  
  332.  
  333.             +o
  334.              The final field is the subject of the  message.   Notice  that
  335.              messages  might  not  have  any subject, as in messages #9 and
  336.              #10.
  337.  
  338.  
  339.             +o
  340.              A maximum of ten messages are displayed at one time.  Further
  341.              into  the  document  we'll  learn how to change "pages" in the
  342.              folder.
  343.  
  344.  
  345.             +o
  346.              The three line menu display will always indicate the  relevant
  347.              commands.   There  are actually two possible menus that can be
  348.              displayed, based on the _u_s_e_r _l_e_v_e_l as set from either the  op-
  349.              tions  screen or the ._e_l_m/_e_l_m_r_c file.  The alternate menu, for
  350.              more advanced users, lists more options;
  351.  
  352.              |=pipe, !=shell, ?=help, <n>=set current to n, /=search pattern
  353.              a)lias, C)copy, c)hange folder, d)elete, e)dit, f)orward, g)roup reply, m)ail,
  354.              n)ext, o)ptions, p)rint, r)eply, s)ave, t)ag, q)uit, u)ndelete, or e(x)it
  355.  
  356.  
  357.             +o
  358.              Finally, the '@' character indicates where  the  cursor  would
  359.              be, awaiting your input.
  360.  
  361.  
  362.           The typical action at this point is to use the  <_r_e_t_u_r_n>  key  to
  363.           read the current message, which will clear the screen and display
  364.           the current message:
  365.  
  366.            Message 1/15 from Larry Fenske         Apr 24 '87 at 8:45 pm edt
  367.                                      Hello there
  368.            Dave,
  369.                 Just wanted to drop you a brief note to see what was going on with
  370.            you this afternoon.  Life here has been the usual fun and games...
  371.                   Ah well, off to the great wilds beyond the desk!
  372.              Larry
  373.            Command ('i' to return to index): @
  374.           __________________________________________________________________
  375.  
  376.           Before we go further with our example, however, let's very quick-
  377.           ly look at all the functions available from the main screen:
  378.  
  379.  
  380.  
  381.  
  382.  
  383.           __________
  384.           1. On screens  with  more  than  24  lines,  additional
  385.           messages  are displayed automatically.  Furthermore, if
  386.           you choose to turn off the menu display, you  can  have
  387.           an even greater number displayed.
  388.  
  389.  
  390.           October 1, 1992                                            Page 5
  391.  
  392.  
  393.  
  394.  
  395.  
  396.           Elm Users Guide                                       Version 2.4
  397.  
  398.  
  399.             CCCCoooommmmmmmmaaaannnndddd   AAAAccccttttiiiioooonnnn
  400.  
  401.  
  402.             <return> or <space>
  403.                       Read current message.
  404.  
  405.             |         Pipe current message or tagged messages to  specified
  406.                       system command.
  407.  
  408.             !         Shell escape.
  409.  
  410.             $         Resynchronize folder.
  411.  
  412.             ?         Help mode - any key pressed will be explained.
  413.  
  414.             + or <right>
  415.                       Display next page of subjects.
  416.  
  417.             - or <left>
  418.                       Display previous page of subjects.
  419.  
  420.             =         Set current message to 1.
  421.  
  422.             *         Set current to last message.
  423.  
  424.             <number><return>
  425.                       Set current message to number _n_u_m_b_e_r.
  426.  
  427.             /         Search for pattern in subject/from lines.
  428.  
  429.             //        Search for pattern in entire folder.
  430.  
  431.             <         Scan message for calendar entries.
  432.  
  433.             >         A synonym for ssss - ssssaaaavvvveeee message or messages.
  434.  
  435.  
  436.             a         Alias, change to "alias" mode.
  437.  
  438.             b         Bounce - remail message (see ffff - ffffoooorrrrwwwwaaaarrrrdddd too).
  439.  
  440.             C         Copy current message or tagged messages to folder.
  441.  
  442.             c         Change to another folder.
  443.  
  444.             d         Delete current message.
  445.  
  446.             <control>-D
  447.                       Delete all messages matching specified pattern.
  448.  
  449.  
  450.           __________
  451.           2. Some sites  might  opt  not  to  have  the  calendar
  452.           feature available.
  453.  
  454.  
  455.           October 1, 1992                                            Page 6
  456.  
  457.  
  458.  
  459.  
  460.  
  461.           Elm Users Guide                                       Version 2.4
  462.  
  463.  
  464.             e         Edit current folder, resyncing upon re-entry.
  465.  
  466.             f         Forward message to specified user.
  467.  
  468.             g         Group reply - reply  to  everyone  who  received  the
  469.                       current message.
  470.  
  471.             h         Display message with headers.
  472.  
  473.             i         Return to index screen after displaying message.
  474.  
  475.             J         Set current to next message.
  476.  
  477.             j or <down>
  478.                       Set current to next message not marked deleted.
  479.  
  480.             K         Set current to previous message.
  481.  
  482.             k or <up> Set current to previous message not marked deleted.
  483.  
  484.             l         Limit displayed messages based on the specified  cri-
  485.                       teria.
  486.  
  487.             <control>-L
  488.                       Rewrite screen.
  489.  
  490.             m         Mail to arbitrary user(s).
  491.  
  492.             n         Read current message, then increment to next  message
  493.                       not marked deleted.
  494.  
  495.             o         Alter current system options.
  496.  
  497.             p         Print current message or tagged messages.
  498.  
  499.             q         Quit - maybe prompting for messages to delete, store,
  500.                       or keep.
  501.  
  502.             Q         Quick quit - like quit but without prompting.
  503.  
  504.             r         Reply to the author of current message.
  505.  
  506.             s         Save current message or tagged messages to folder.
  507.  
  508.             t         Tag current message.
  509.  
  510.  
  511.           __________
  512.           3. Some sites might opt not to  have  the  edit  folder
  513.           feature available.
  514.           4. The difference between ffffoooorrrrwwwwaaaarrrrdddd and bbbboooouuuunnnncccceeee is  rather
  515.           subtle  -  a  forwarded  message  is _f_r_o_m you, with the
  516.           original message included, whereas a bounced message is
  517.           still from the original sender.
  518.  
  519.  
  520.           October 1, 1992                                            Page 7
  521.  
  522.  
  523.  
  524.  
  525.  
  526.           Elm Users Guide                                       Version 2.4
  527.  
  528.  
  529.             <control>-T
  530.                       Tag all messages matching specified pattern.
  531.  
  532.             u         Undelete current message.
  533.  
  534.             <control>-U
  535.                       Undelete all messages matching specified pattern.
  536.  
  537.             x         Exit - prompt if mailbox  changed,  don't  record  as
  538.                       read, don't save.
  539.  
  540.             X         Exit immediately - don't record as read, don't save.
  541.  
  542.           But let's go back to our example and see some of  this  at  work,
  543.           shall we?
  544.  
  545.           We were reading the message from  Larry  and  the  screen  looked
  546.           like:
  547.  
  548.            Message 1/15 from Larry Fenske         Apr 24 '87 at 8:45 pm edt
  549.                                      Hello there
  550.            Dave,
  551.                 Just wanted to drop you a brief note to see what was going on with
  552.            you this afternoon.  Life here has been the usual fun and games...
  553.                             Ah well, off to the great wilds beyond the desk!
  554.                       Larry
  555.            Command ('i' to return to index): @
  556.           __________________________________________________________________
  557.  
  558.           From this point let's go ahead and reply to the message.   To  do
  559.           this,  we can use the rrrreeeeppppllllyyyy command.  To do this, we type 'r' and
  560.           the last few lines change to something like:
  561.  
  562.           -----------------------------------------------------------------
  563.           Command: Reply to message                  Copy message? (y/n) @
  564.  
  565.  
  566.           To which we decide that we don't need the text of this message in
  567.           our  new one, so we reply _n_o by pressing the 'n' key.  The bottom
  568.           part of the window then changes to:
  569.  
  570.           -----------------------------------------------------------------
  571.           Command: Reply to message                       To: Larry Fenske
  572.           Subject: Re: Hello there@
  573.  
  574.  
  575.           At this point we can either decide to enter a  new  subject  (you
  576.           could  use  either _b_a_c_k_u_p _w_o_r_d (<_c_o_n_t_r_o_l>-_W) or _b_a_c_k_u_p _l_i_n_e (this
  577.           is the  same  as  your  "line  kill"  character,  <_c_o_n_t_r_o_l>-_X  or
  578.           <_c_o_n_t_r_o_l>-_U  usually))  or go with this one by pressing <_r_e_t_u_r_n>.
  579.           We'll just leave it as it is and  press  <_r_e_t_u_r_n>,  changing  the
  580.           screen to:
  581.  
  582.           -----------------------------------------------------------------
  583.           Command: reply to message                       To: Larry Fenske
  584.  
  585.  
  586.           October 1, 1992                                            Page 8
  587.  
  588.  
  589.  
  590.  
  591.  
  592.           Elm Users Guide                                       Version 2.4
  593.  
  594.  
  595.           Subject: Re: Hello there
  596.           Copies to: @
  597.  
  598.           There's no one we want to have receive copies of this message, so
  599.           we'll just press <_r_e_t_u_r_n> again to indicate this.
  600.  
  601.           Once you've answered these questions the  program  will  put  you
  602.           into  your  favorite editor and let you compose a response.  When
  603.           you're done it then asks:
  604.  
  605.           Please choose one of the following options by parenthesized letter: @
  606.                e)dit message, edit h)eaders, s)end it, or f)orget it.
  607.  
  608.           Since we're just interested in sending  the  message  out,  we'll
  609.           choose the sssseeeennnndddd option and press 's'.  The program then sends the
  610.           message, indicating that by the line below saying:
  611.  
  612.               Sending mail...
  613.  
  614.           then putting at the bottom of the screen ``Mail sent!'' and  giv-
  615.           ing us the prompt:
  616.  
  617.           -----------------------------------------------------------------
  618.           Command:                            (Use 'i' to return to index.)
  619.  
  620.           Pretty easy, isn't it?  Let's continue by going back to the  main
  621.           screen  pressing the 'i' key to request the _i_n_d_e_x.  The screen is
  622.           then:
  623.  
  624.  
  625.             Mailbox is '/usr/mail/mymail' with 15 messages  [Elm 2.4PL22]
  626.            ->         1   Apr 24   Larry Fenske   (49)    Hello there
  627.                 N     2   Apr 24   jad@hpcnoe     (84)    Chico?  Why go there?
  628.                 E     3   Apr 23   Carl Smith     (53)    Dinner tonight?
  629.                 NU    4   Apr 18   Don Knuth      (354)   Your version of TeX...
  630.                 N     5   Apr 18   games          (26)    Bug in cribbage game
  631.                  A    6   Apr 15   kevin          (27)    More software requests
  632.                       7   Apr 13   John Jacobs    (194)   How can you hate RUSH?
  633.                  U    8   Apr 8    decvax!mouse   (68)    Re: your Usenet article
  634.                       9   Apr 6    root           (7)
  635.                 O    10   Apr 5    root           (13)
  636.  
  637.           You can use any of the following commands by pressing the first character;
  638.           d)elete or u)ndelete mail, m)ail a message, r)eply or f)orward mail, q)uit
  639.           To read a message, press <return>.  j = move down, k = move up, ? = help
  640.            Command : @
  641.  
  642.           __________________________________________________________________
  643.  
  644.           Notice that the first message is no longer marked  as  _n_e_w  since
  645.           we've now read it.
  646.  
  647.           Let's go ahead and read the message from kevin (message #6) since
  648.           it  has  some  sort  of  _a_c_t_i_o_n associated with it anyway.  To do
  649.           this, we simply press the '6' key, which will change  the  bottom
  650.  
  651.  
  652.           October 1, 1992                                            Page 9
  653.  
  654.  
  655.  
  656.  
  657.  
  658.           Elm Users Guide                                       Version 2.4
  659.  
  660.  
  661.           of the screen to:
  662.  
  663.           Command: New Current Message          Set current message to : 6@
  664.  
  665.           We'll just press <_r_e_t_u_r_n> to move the active message pointer (the
  666.           arrow).
  667.  
  668.           Now we're pointing at the new message, so let's go ahead and read
  669.           it by pressing <_r_e_t_u_r_n> again, giving us:
  670.  
  671.            Message 6/15 from kevin               Apr 15 '87 at 11:36 am pst
  672.                                More software requests
  673.            Action: please acknowledge receipt
  674.            I don't suppose you have a nifty netnews reader around  too,  do
  675.           you??
  676.            --
  677.            kevin
  678.            Command ('i' to return to index): @
  679.           __________________________________________________________________
  680.  
  681.  
  682.           Well, it turns out that we don't, but a friend of ours  does,  so
  683.           let's ffffoooorrrrwwwwaaaarrrrdddd the message to them by pressing 'f':
  684.  
  685.           Command: Forward message         Edit outgoing message (y/n) ? @
  686.  
  687.  
  688.           No need to edit it, so let's answer _n_o with 'n':
  689.  
  690.           Command: Forward message        Edit outgoing message (y/n) ? No
  691.           To: @
  692.  
  693.           We type in the address of the person we're forwarding to (in this
  694.           case usenet) and press <_r_e_t_u_r_n>:
  695.  
  696.           Command: Forward message                              To: usenet
  697.           Subject: More software requests (fwd)@
  698.  
  699.           To which we again press <_r_e_t_u_r_n> to  take  the  default  subject.
  700.           Elm  asks for any possible copy recipients, asks us if we're sure
  701.           we want to send it, and shoots it off.
  702.  
  703.           Enough mail for now, however, so we just eeeexxxxiiiitttt by pressing the 'x'
  704.           key  at  the "Command:" prompt and the program drops us back into
  705.           our shell.
  706.  
  707.           As you can see, it's quite easy to use the Elm system, so  rather
  708.           than  continue with our example, let's look at some other aspects
  709.           of the program.
  710.  
  711.  
  712.           3333....  NNNNoooonnnn----IIIInnnntttteeeerrrraaaaccccttttiiiivvvveeee UUUUsssseeeessss ooooffff EEEEllllmmmm
  713.  
  714.           Before we go ahead and discuss the Elm utilities, it's worth not-
  715.           ing  that  there  are a couple of other ways to use the main mail
  716.  
  717.  
  718.           October 1, 1992                                           Page 10
  719.  
  720.  
  721.  
  722.  
  723.  
  724.           Elm Users Guide                                       Version 2.4
  725.  
  726.  
  727.           system, namely to "send only" and to send files (batchmail).
  728.  
  729.           To send a message to someone without any of the associated  over-
  730.           head  of reading in a mail folder, you can invoke the mailer with
  731.           the name(s) of the people to send to.  For example:
  732.  
  733.                $ eeeellllmmmm ddddaaaavvvveeee____ttttaaaayyyylllloooorrrr
  734.  
  735.           Elm then prompts for Subject, Copies, and then drops you in  your
  736.           editor  (defined  in the ._e_l_m/_e_l_m_r_c file) to compose the message.
  737.           When composition is complete, the program  verifies  transmission
  738.           then terminates.
  739.  
  740.           Elm also supports batch type mailing, of files and so on, by  us-
  741.           ing the following command:
  742.  
  743.                $ eeeellllmmmm ddddaaaavvvveeee____ttttaaaayyyylllloooorrrr <<<< hhhheeeellllpppp....cccc
  744.  
  745.           which reads in the file and transmits it to the specified user.
  746.  
  747.           A subject may be specified with "-s _s_u_b_j_e_c_t" as an option to  Elm
  748.           in either "send only" or "batch" modes, as in:
  749.  
  750.                $ eeeellllmmmm ----ssss """"FFFFiiiilllleeee hhhheeeellllpppp....cccc,,,, aaaassss pppprrrroooommmmiiiisssseeeedddd"""" ddddaaaavvvveeee____ttttaaaayyyylllloooorrrr <<<< hhhheeeellllpppp....cccc
  751.  
  752.           Elm also has an option to specify that a certain file be used  as
  753.           the initial text of the message.  This makes it easier to use Elm
  754.           with other programs that interface with a mailer.  Use "-i  _f_i_l_e"
  755.           as an option to Elm in "send only" mode.  For example, to specify
  756.           to _r_n to use Elm as the mailer, define the following in RRRRNNNNIIIINNNNIIIITTTT:
  757.  
  758.                -EMAILPOSTER="elm -i %h -s \"Re: %S\" %t"
  759.  
  760.           See the man page for _r_n(1) or the newsreader  you  use  for  more
  761.           specific information.
  762.  
  763.  
  764.  
  765.           4444....  TTTThhhheeee EEEEllllmmmm UUUUttttiiiilllliiiittttiiiieeeessss
  766.  
  767.           The Elm mail system is really much more than a single program for
  768.           reading  and writing mail.  It's a unified environment for intel-
  769.           ligently dealing with electronic  correspondence.   As  a  conse-
  770.           quence, it contains a number of other programs to aid in the easy
  771.           processing of "email", including the following;
  772.  
  773.  
  774.            answer   An answering-machine transcription program.  Please see
  775.                     the  manual  entry  for  more information on how to use
  776.                     this program.
  777.  
  778.  
  779.            checkalias
  780.                     A script for checking aliases simply.
  781.  
  782.  
  783.           October 1, 1992                                           Page 11
  784.  
  785.  
  786.  
  787.  
  788.  
  789.           Elm Users Guide                                       Version 2.4
  790.  
  791.  
  792.            elmalias A tool to obtain information on defined aliases.
  793.  
  794.  
  795.            listalias
  796.                     A script to produce sorted listings of aliases.
  797.  
  798.  
  799.            messages A script that lists  the  number  of  messages  in  the
  800.                     specified folder.  Suitable for login scripts and such.
  801.  
  802.  
  803.            newmail  This program monitors a mailbox or set of mailboxes and
  804.                     can  output notification of new mail in one of two pos-
  805.                     sible formats; either:
  806.  
  807.                          >> New mail from Jimmy Carter -- Urgent matters of state
  808.                          >> New mail from joe@ucbvax.arpa -- Did I hear someone say PARTY??
  809.  
  810.                     if running as _n_e_w_m_a_i_l or:
  811.  
  812.                          Jimmy Carter -- Urgent matters of state
  813.                          joe@ucbvax.arpa -- Did I hear someone say PARTY??
  814.  
  815.                     if running as _w_n_e_w_m_a_i_l.  BSD Users will find this is  a
  816.                     far superior _b_i_f_f program.
  817.  
  818.  
  819.            wnewmail This is the same program as _n_e_w_m_a_i_l, but has  different
  820.                     defaults if invoked this way.
  821.  
  822.  
  823.            readmsg  This handy little program can  be  used  in  two  ways.
  824.                     First  off,  it  can  be used to easily read a specific
  825.                     message in the incoming mailbox, specified  by  ordinal
  826.                     number,  by  a string that the message contains, by the
  827.                     metacharacter '$' which represents the last message  in
  828.                     the  folder,  or  '*' which matches all the messages in
  829.                     the folder.
  830.  
  831.                     For example;
  832.  
  833.                          $ rrrreeeeaaaaddddmmmmssssgggg 4444 5555 9999 |||| llllpppprrrr
  834.  
  835.                     would generate a printout, _s_a_n_s superfluous headers, of
  836.                     the fourth, fifth and ninth messages in your mailbox.
  837.  
  838.                          $ rrrreeeeaaaaddddmmmmssssgggg CCCCaaaarrrrtttteeeerrrr |||| ppppaaaaggggeeee
  839.  
  840.                     would be a fast way to read what 'ole Jimmy has to say,
  841.                     and
  842.  
  843.                          $ rrrreeeeaaaaddddmmmmssssgggg ----hhhh hhhheeeeaaaarrrr ssssoooommmmeeeeoooonnnneeee ssssaaaayyyy
  844.  
  845.                     would list, including  all  the  message  headers,  the
  846.  
  847.  
  848.           October 1, 1992                                           Page 12
  849.  
  850.  
  851.  
  852.  
  853.  
  854.           Elm Users Guide                                       Version 2.4
  855.  
  856.  
  857.                     message containing the string "hear someone say".
  858.  
  859.  
  860.            frm      Similar to the Berkeley _f_r_o_m command,  this  will  give
  861.                     you  a  "table  of contents" or a summary of either the
  862.                     current mailbox or a mailbox  of  your  choice.    It's
  863.                     useful  to  see  what  mail  is pending, or what's in a
  864.                     mailbox.  If used with the "-n" option, it will  number
  865.                     each  message  in  a  way compatible with the arguments
  866.                     _r_e_a_d_m_s_g expects to get, too!
  867.  
  868.  
  869.            newalias This is used to install new user/group aliases.  Please
  870.                     see _T_h_e _E_l_m _A_l_i_a_s _U_s_e_r_s _G_u_i_d_e for further information.
  871.  
  872.  
  873.            fastmail Sometimes you want to have a batchmailing  system  that
  874.                     works  as  quickly  as  possible,  not  bothering  with
  875.                     aliases or any of the other "deluxe" features  of  Elm.
  876.                     An example of this would be if you have a large mailing
  877.                     list for a newsletter, say.  This command, _f_a_s_t_m_a_i_l, is
  878.                     designed  just for that purpose.  It avoids the lengthy
  879.                     startup time of Elm while still generating  valid  RFC-
  880.                     822 mail.  Please see the manual entry for more infor-
  881.                     mation on this command.
  882.  
  883.  
  884.           5555....  CCCCrrrreeeeddddiiiittttssss aaaannnndddd SSSSoooo oooonnnn ---- EEEEllllmmmm''''ssss eeeeaaaarrrrllllyyyy yyyyeeeeaaaarrrrssss ffffrrrroooommmm DDDDaaaavvvveeee TTTTaaaayyyylllloooorrrr
  885.  
  886.           This mailer has been evolving over the past few  years  with  in-
  887.           valuable  comments  on the interface and general mail issues from
  888.           the following people; Jim Davis, Steve Wolf (or should  that  say
  889.           Steve!! Wolf!!!! perhaps?), Larry Fenske, Rob Sartin, John Dilley
  890.           and Carl Dierschow.
  891.  
  892.           For the Berkeley implementation, lots of help came from both John
  893.           Lebovitz and Ken Stone.
  894.  
  895.           For the Amdahl/UTS implementation, thanks to Scott  McGregor  and
  896.           Stan Isaacs.
  897.  
  898.           For the Sun problems, Dave England in Lancaster (UK)  turned  out
  899.           to be "bloody useful", as he would no doubt say.
  900.  
  901.           The Pyramid version is due to the work of  Steve  Malone  of  the
  902.           University of Washington.
  903.  
  904.           A number of other people have been amazingly disciplined  at  re-
  905.           porting  problems and (usually, much to my relief) indicating the
  906.           fixes needed, especially Guy Hillyer,  Bruce  Townsend  and  Eric
  907.  
  908.           __________
  909.           5. If you don't know what RFC-822 is, don't worry about
  910.           it!
  911.  
  912.  
  913.           October 1, 1992                                           Page 13
  914.  
  915.  
  916.  
  917.  
  918.  
  919.           Elm Users Guide                                       Version 2.4
  920.  
  921.  
  922.           Negaard.
  923.  
  924.           There have been many, many others, too numerous to mention,  that
  925.           have  inspired  me with questions like "Why can't Elm..." or "Why
  926.           does it ..." or "Can we make it..." too.  A  loud  round  of  ap-
  927.           plause and an enthusiastic THANK YOU to you all!!
  928.  
  929.           Also helpful was the ability to have my "own" machine to close up
  930.           the many many iterative loops that this software has gone through
  931.           - since being on a big multi-user machine tends to slow  it  down
  932.           to a standstill.  For that, I thank Hewlett-Packard Colorado Net-
  933.           works Division for their initial support, and now HP Laboratories
  934.           for the wonderful working environment that I have here (more than
  935.           any one person is safe having, I suspect).
  936.  
  937.           Mailers that have influenced the  design  and  implementation  of
  938.           Elm, for better or worse, include the following;
  939.  
  940.  
  941.            /_b_i_n/_m_a_i_l
  942.                     The most basic of mailers, this one was simply the  ex-
  943.                     ample  of  how _n_o_t to force the user to interact with a
  944.                     program.
  945.  
  946.  
  947.            _B_e_r_k_e_l_e_y _M_a_i_l
  948.                     A surprisingly  sophisticated  mailer,  especially  the
  949.                     version  with 4.3 BSD, _B_e_r_k_e_l_e_y _M_a_i_l still suffers from
  950.                     the tendency to force the user to know too  much  about
  951.                     the  system, and also lacks a friendly, non-cryptic in-
  952.                     terface for the large subset of the population that use
  953.                     UNIX but aren't interested in becoming a "hacker".
  954.  
  955.  
  956.            _M_H       This is another  nifty  mailer.   The  main  difference
  957.                     between  this and the other mailers about is that it is
  958.                     a discrete set of programs rather than a single unified
  959.                     interface.   This is quite useful for those people that
  960.                     receive _l_o_t_s of mail and are willing to spend some time
  961.                     learning  the  intricacies  of the program.  It's quite
  962.                     powerful, but again, misses some of the basic  friendly
  963.                     features the majority of users are interested in.
  964.  
  965.  
  966.            _d_m_a_i_l    A sort of mutated cross between _M_H and  _B_e_r_k_e_l_e_y  _M_a_i_l,
  967.                     it  was this program that convinced me to implement the
  968.                     lllliiiimmmmiiiitttt functions.
  969.  
  970.  
  971.            _N_M_a_i_l    A part of the HP AI Workstation  Software  Environment,
  972.                     this  program  hints at the power that mailers could be
  973.                     given to help deal with mail in a quick and intelligent
  974.                     fashion.   Most  of what it can do, and a lot more, are
  975.                     therefore part of Elm.  Indubitably.   And  quite  fast
  976.  
  977.  
  978.           October 1, 1992                                           Page 14
  979.  
  980.  
  981.  
  982.  
  983.  
  984.           Elm Users Guide                                       Version 2.4
  985.  
  986.  
  987.                     too!
  988.  
  989.  
  990.            _P_M_X/_T_E_R_M Part of the AT&T Mail package, a single glance at  this
  991.                     interface convinced me that a PC interface, with almost
  992.                     half of the screen taken up by  a  silly  function  key
  993.                     mapping,  is  most certainly _n_o_t the way to do things!!
  994.                     On the other hand, it also shows that the "forms"  mode
  995.                     can be quite nicely integrated into a more sophisticat-
  996.                     ed mailer.
  997.  
  998.  
  999.            _f_m_a_i_l    A nickel addition to the /_b_i_n/_m_a_i_l program to add  some
  1000.                     rudimentary  screen  interface  stuff, this nonetheless
  1001.                     interesting mailer is part of the AT&T Toolchest.
  1002.  
  1003.  
  1004.            _L_a_u_r_e_l   A program only available within Xerox PARC, this was an
  1005.                     interesting  early  attempt  at  a graphics based full-
  1006.                     screen mail program.  The one, perhaps trivial, part of
  1007.                     the  interface I really like was the fact that it would
  1008.                     _c_r_o_s_s _o_u_t a message that was marked for deletion.   One
  1009.                     day  when  we  get real graphics and the ability to use
  1010.                     them in a facility (not too) like _t_e_r_m_c_a_p, perhaps  Elm
  1011.                     will do this too!
  1012.  
  1013.  
  1014.            _M_a_i_l_t_o_o_l Part of the Sun distribution package, this program is a
  1015.                     really  nice  example  of what can be done by putting a
  1016.                     smart shell  on  top  of  a  dumb  program  -  it  uses
  1017.                     /_b_i_n/_m_a_i_l  for  all the "dirty work".  Other than that,
  1018.                     it's  not  a  particularly  interesting  interface   or
  1019.                     mailer,  and it certainly doesn't add much functionali-
  1020.                     ty!
  1021.  
  1022.  
  1023.            _M_e_t_a_m_a_i_l What can I say?  This isn't even a real mailer, but is
  1024.                     just what I dream of as an interface to mail in the fu-
  1025.                     ture.  A program that works sort of  like  HAL  did  in
  1026.                     _2_0_0_1:  _A  _S_p_a_c_e _O_d_y_s_s_e_y - where it interrupts me as ap-
  1027.                     propriate for important mail, and can answer inane  and
  1028.                     other  queries  itself  according  to  what I teach it.
  1029.                     Maybe Elm, by some  sort  of  groupmind  metamorphosis,
  1030.                     will  change  into  that someday.  Maybe not.  Maybe no
  1031.                     one bothers to read this far into the document!!
  1032.  
  1033.           Finally, it's also been a very useful  experience  overall,  con-
  1034.           firming  my  beliefs that iterative software design and keeping a
  1035.           close watch on users (not to mention an open mind  and  mailbox!)
  1036.           improves  a product manyfold.  Comments, feedback and bug reports
  1037.  
  1038.           __________
  1039.           6. Not to be  confused  with  the  multi-media  mailer,
  1040.           _m_e_t_a_m_a_i_l, from Nathaniel Borenstein of Bellcore.
  1041.  
  1042.  
  1043.           October 1, 1992                                           Page 15
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.           Elm Users Guide                                       Version 2.4
  1050.  
  1051.  
  1052.           (and fixes!) are, of course, always welcome!
  1053.  
  1054.  
  1055.           6666....  CCCCrrrreeeeddddiiiittttssss aaaannnndddd SSSSoooo oooonnnn PPPPaaaarrrrtttt IIIIIIII ---- TTTThhhheeee UUUUsssseeeennnneeeetttt EEEEllllmmmm DDDDeeeevvvveeeellllooooppppmmmmeeeennnntttt GGGGrrrroooouuuupppp
  1056.  
  1057.           As coordinator of the Elm Development Group, I must  add  to  the
  1058.           credits.   This  group  of volunteers has taken the Elm code from
  1059.           Dave Taylor and added features, made it  more  robust,  and  more
  1060.           portable.
  1061.  
  1062.           For getting the Usenet Elm  group  going,  for  without  which  I
  1063.           wouldn't  be writing this, thanks to Greg Hackney at Southwestern
  1064.           Bell Telephone Co.
  1065.  
  1066.           For the Configuration system and  its  newer  Dist  2.0  version,
  1067.           thanks are due to Larry Wall of JPL-NASA.
  1068.  
  1069.           For his over two hundred sets of changes to version 2.2, Elm owes
  1070.           a lot to Rob Bernardo who was at Pacbell at that time.
  1071.  
  1072.           The ability to run Elm at all on Intel 286 machines owes a lot to
  1073.           the insistent nudging of the coordinator by Chip Salzenberg, Chip
  1074.           Rosenthal, and Tim Evans.
  1075.  
  1076.           For getting us the rights to use the news macros  and  converting
  1077.           all the documentation over to those macros, thanks to Mike Brown.
  1078.  
  1079.           For pushing us into the '90s and forcing the issues  of  NLS  and
  1080.           foreign  language  support, I thank Jan Saell of Administration &
  1081.           Systemkonsult AB along with Larry Philps of SCO Canada.  I'd also
  1082.           like  to  thank  the  many  current  and prior members of the Elm
  1083.           development and testing groups.  The list  varies  from  time  to
  1084.           time as people come and go.  Also, to all the Elm users out there
  1085.           who send in patches.  The group can use all  the  extra  help  it
  1086.           gets.   As  a  postScript,  if you wish to join the group, all it
  1087.           takes is some time to work on things, and to ask.
  1088.  
  1089.           Syd Weinstein, Elm Coordinator.
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.           October 1, 1992                                           Page 16
  1109.  
  1110.  
  1111.  
  1112.